Request
curl --location --request GET 'https://openapi.gs-robot.com/openapi/v2alpha1/s/robots/*/status:batchGet'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {{token}}'
--data '{
"names": "TEST00-0000-000-S003",
"names": "TEST00-0000-000-B001"
}'
Response
{
"robotStatus": [
{
"serialNumber": "TEST00-0000-000-S086",
"taskState": "PAUSED",
"online": true,
"speedKilometerPerHour": 0,
"battery": {
"charging": false,
"powerPercentage": 64,
"chargerCurrent": 0
},
"emergencyStop": {
"enabled": false
},
"localizationInfo": {
"localizationState": "NORMAL",
"map": {
"id": "086cb47d-34d0-4a1f-9ee3-f372f1fa1ba1",
"name": "10F（梯控）",
"version": "maps/37c2603c-c00c-11ee-a0cd-09c231bc72e3/versions/628baece-a8ab-11ef-84ce-056df04db391"
},
"mapPosition": {
"x": 295,
"y": 150,
"angle": -100.649,
"worldX": 1.234,
"worldY": 2.345
}
},
"cleanModes": [
{
"name": "清洗"
},
{
"name": "清扫"
},
{
"name": "尘推"
},
{
"name": "吸尘"
}
],
"supportSite": true,
"navigationPoints": {
"naviPoints": [
{
"naviPointName": "ElevatorWaitingPosition",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "sw座位",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "前台",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": " 电梯间",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "项目",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "算法",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "Current",
"navPointGridX": 0,
"navPointGridY": 0
}
]
},
"workModes": [
{
"id": "03d40cb292754452aeb96932c90787b9",
"name": "清洗",
"strength": "prefer_custom",
"type": "1"
},
{
"id": "09f32e0e25154338ad149cbff97f8c4b",
"name": "清扫",
"strength": "prefer_custom",
"type": "1"
},
{
"id": "2f5261caf6284bb79e9023c6858e3833",
"name": "尘推",
"strength": "prefer_custom",
"type": "1"
},
{
"id": "19f32e0e25154338ad149cbff97f8c4b",
"name": "吸尘",
"strength": "prefer_custom",
"type": "1"
}
],
"currentTask": {
"workMode": {
"id": "09f32e0e25154338ad149cbff97f8c4b",
"name": "清扫",
"type": 0,
"subType": "sweep",
"strength": "prefer_custom"
},
"taskInstanceId": "c4c8733f-90f9-4981-a1fb-a601414992e5",
"manualControlling": false
},
"device": {
"cleanWaterTank": {
"level": 80
},
"recoveryWaterTank": {
"level": 50
},
"rollingBrush": {
"enabled": false,
"ifPutDown": true,
"lifeSpan": 300,
"usedLife": 0,
"motorFront": -1,
"motorAfter": 0
},
"rightSideBrush": {
"lifeSpan": 300,
"usedLife": 0,
"isRunning": false
},
"softSqueegee": {
"ifPutDown": false,
"lifeSpan": 300,
"usedLife": 0
},
"rollingSqueegee": {
"ifPutDown": false
},
"spray": {
"isRunning": false,
"waterLevel": -1
},
"vacuum": {
"enabled": false,
"level": -1
},
"cleanWaterFilter": {
"lifeSpan": 600,
"usedLife": 0
},
"hepaSensor": {
"lifeSpan": 600,
"usedLife": 0
}
},
"navStatus": "NAVI_IDLE",
"currentElevatorStatus": "ELEVATOR_CONTROLLER_IDLE",
"latestReportTime": "1777282199509"
},
{
"serialNumber": "TEST00-0000-000-S013",
"taskState": "PAUSED",
"online": true,
"speedKilometerPerHour": 0,
"battery": {
"charging": false,
"powerPercentage": 64,
"chargerCurrent": 0
},
"emergencyStop": {
"enabled": false
},
"localizationInfo": {
"localizationState": "NORMAL",
"map": {
"id": "086cb47d-34d0-4a1f-9ee3-f372f1fa1ba1",
"name": "10F（梯控）",
"version": "maps/37c2603c-c00c-11ee-a0cd-09c231bc72e3/versions/628baece-a8ab-11ef-84ce-056df04db391"
},
"mapPosition": {
"x": 295,
"y": 150,
"angle": -100.649,
"worldX": 1.234,
"worldY": 2.345
}
},
"cleanModes": [
{
"name": "清洗"
},
{
"name": "清扫"
},
{
"name": "尘推"
},
{
"name": "吸尘"
}
],
"supportSite": true,
"navigationPoints": {
"naviPoints": [
{
"naviPointName": "ElevatorWaitingPosition",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "sw座位",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "前台",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "电梯间",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "项目",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "算法",
"navPointGridX": 0,
"navPointGridY": 0
},
{
"naviPointName": "Current",
"navPointGridX": 0,
"navPointGridY": 0
}
]
},
"workModes": [
{
"id": "03d40cb292754452aeb96932c90787b9",
"name": "清洗",
"strength": "prefer_custom",
"type": "1"
},
{
"id": "09f32e0e25154338ad149cbff97f8c4b",
"name": "清扫",
"strength": "prefer_custom",
"type": "1"
},
{
"id": "2f5261caf6284bb79e9023c6858e3833",
"name": "尘推",
"strength": "prefer_custom",
"type": "1"
},
{
"id": "19f32e0e25154338ad149cbff97f8c4b",
"name": "吸尘",
"strength": "prefer_custom",
"type": "1"
}
],
"currentTask": {
"workMode": {
"id": "09f32e0e25154338ad149cbff97f8c4b",
"name": "清扫",
"type": 0,
"subType": "sweep",
"strength": "prefer_custom"
},
"taskInstanceId": "c4c8733f-90f9-4981-a1fb-a601414992e5",
"manualControlling": false
},
"device": {
"cleanWaterTank": {
"level": 80
},
"recoveryWaterTank": {
"level": 50
},
"rollingBrush": {
"enabled": false,
"ifPutDown": true,
"lifeSpan": 300,
"usedLife": 0,
"motorFront": -1,
"motorAfter": 0
},
"rightSideBrush": {
"lifeSpan": 300,
"usedLife": 0,
"isRunning": false
},
"softSqueegee": {
"ifPutDown": false,
"lifeSpan": 300,
"usedLife": 0
},
"rollingSqueegee": {
"ifPutDown": false
},
"spray": {
"isRunning": false,
"waterLevel": -1
},
"vacuum": {
"enabled": false,
"level": -1
},
"cleanWaterFilter": {
"lifeSpan": 600,
"usedLife": 0
},
"hepaSensor": {
"lifeSpan": 600,
"usedLife": 0
}
},
"navStatus": "NAVI_IDLE",
"currentElevatorStatus": "ELEVATOR_CONTROLLER_IDLE",
"latestReportTime": "1777282199509"
}
]
}
Note:
worldXandworldYare effective only when the robot is online. When the robot is offline, world coordinates cannot be calculated and both fields return the default value0. If localization, grid coordinates, or map metadata are unavailable, the coordinates cannot be populated.